home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / prep110.zip / PROTOREP.DOC < prev    next >
Text File  |  1989-02-19  |  17KB  |  298 lines
  1.  
  2.      ProtoRep v1.10
  3.      ==============
  4.      This program is the property of Michael S. Cox. Altering and/or
  5.      selling ProtoRep is prohibited without the written consent of Michael
  6.      S. Cox. You may use the program and distribute it without charge,
  7.      except for a disk fee not to exceed $1 for 5 1/4" DS/DD disks, $2 for
  8.      5 1/4" DS/HD disks, $2 for 3 1/2" DS/DD disks, and $10 for 3 1/2"
  9.      DS/HD disks. If you have to pay more for the disks than the above,
  10.      you're being ripped off and should look for another vendor. For
  11.      contribution/registration information, see the Future section at the
  12.      end of this documentation.
  13.  
  14.      ProtoRep is a program that simplifies using external protocols. It
  15.      allows you to add up to 12 (in this version) external protocols
  16.      easily. It's much handier than a slew of .BAT files to do the same
  17.      function.
  18.  
  19.      Many communications programs only have one or two file transfer
  20.      protocols available. Two examples are Bitcom and Smartcom. To use any
  21.      of the more advanced protocols such as Zmodem, you have to 'shell' out
  22.      of the comm. program and execute the external protocol along with it's
  23.      cumbersome command line. Later in the industry came programs that
  24.      allowed external protocols to be added to its menus through the use of
  25.      .BAT files. Two examples of this are Qmodem and Telix. But even these
  26.      programs had minor limitations on the number of protocols you could add.
  27.      The main function of ProtoRep, however, is for the user who has a 
  28.      communication program that supports a small amount of protocols, and
  29.      doesn't allow user-defining new protocols.
  30.  
  31.      What's New?
  32.      ===========
  33.      V1.10 re-worked the input scheme. Previously, I had used the ON KEY
  34.      statements in QuickBASIC, but because of problems with 101-key 
  35.      keyboards, and a trailing keystroke if a user keys to fast, I have
  36.      done away with it, and used a much cleaner approach of using ASCII
  37.      scan codes. Also in 1.10, the first letter of each command can be
  38.      use to execute that command. For instance, Typing 'S' will execute
  39.      the Send File(s) routine.
  40.  
  41.      Installation
  42.      ============
  43.      ProtoRep can be invoked three ways: (1) exiting the comm. program
  44.      through a DOS shell (jumping out to DOS while the comm. program is
  45.      still loaded) and running PROTOREP.EXE, (2) installing ProtoRep as an
  46.      external protocol in the more advanced communication packages, or (3)
  47.      in the worse scenario, if the comm. package doesn't have either of the
  48.      two above capabilities, but does allow you to exit the program without
  49.      hanging up, you can exit the comm. program, run PROTOREP.EXE, and
  50.      restart the comm. program. If you use option two (2), and your comm.
  51.      program forces you to have a .BAT file to run as an external protocol,
  52.      you can create a .BAT file called PREP.BAT that simply contains the
  53.      line PROTOREP.
  54.  
  55.      Before you can use ProtoRep successfully, you must configure it to
  56.      meet your needs. Type PROTOREP /C to configure ProtoRep. You will be
  57.      asked five questions:
  58.  
  59.         1)  Is your system color or monochrome? This needs no explanation.
  60.             If you have an old IBM CGA adapter, you may experience some
  61.             snow during ProtoRep's execution. To remedy this, get in the
  62.             80's. Get yourself a decent video board or upgrade to EGA or
  63.             VGA. (I'd even consider Hercules Monochrome an upgrade over
  64.             CGA!)
  65.  
  66.         2)  Default directory for receive files. This is the drive and path
  67.             of where you would like all your downloads to go. Key in the
  68.             FULL path name such as C:\DOWN. If you just leave this blank,
  69.             the default directory will be used.
  70.  
  71.         3)  Default communications port. This is the COM port your modem is
  72.             normally using. Most the time, this does not change. ProtoRep
  73.             will allow you to specify COM ports occupying COM1 through
  74.             COM8. I have yet to see a package or protocol that uses higher
  75.             than COM8. Most decent packages support up through COM4. Just
  76.             key in the 1 character number such as '1' for COM1 or '2' for
  77.             COM2. Do not key in the whole port address such as 'COM1'.
  78.  
  79.         4)  Default communications speed. This is the baud rate you are
  80.             normally set at. ProtoRep allows speeds of 300, 1200, 2400,
  81.             4800, 9600, and 19200. I have yet to see anyone going faster
  82.             than this for file transfers. You can override these default
  83.             setting for COM port and speed by typing them on the PROTOREP
  84.             command line. PROTOREP 2 2400 would set PROTOREP up for COM2 at
  85.             2400 baud. This would not change the default configuration of
  86.             PROTOREP, just for the duration of the current session. If your
  87.             comm. packages will utilize such a command line, it will be
  88.             necessary to run from a .BAT file that specifies PROTOREP %1 %2
  89.             or in whatever order your comm. package issues those
  90.             parameters. For example, Telix v3.11 would be PROTOREP %2 %1
  91.             because it sends speed as the first parameter, and port number
  92.             as the second.
  93.  
  94.         5)  Should ProtoRep be noisy? Well, ProtoRep isn't TOO noisy. Just
  95.             a small clink when you hit the up/down arrow keys, and a quick
  96.             tone when you hit enter. You can re-run PROTOREP /C as often as
  97.             you like to test out if you like the noise or not.
  98.  
  99.      These answers are stored in a file called PROTOREP.CFG and can be
  100.      altered using an ASCII editor.
  101.  
  102.      Usage
  103.      =====
  104.      ProtoRep is quite straight forward. You have 6 menu options. To pick
  105.      an option, use the cursor keys, or arrow keys, to highlight the option
  106.      you want and hit <ENTER>. ProtoRep wraps the options, so if you're
  107.      highlighting "Quit", the last option, and hit <downarrow>, "Send
  108.      File(s)", the first option, will be highlighted. This goes both ways.
  109.      Also, you may hit the first letter of the command you wish to execute.
  110.      For instance, hitting the 'S' key will execute the 'Send File(s)'
  111.      command, and 'I' will execute 'Install Protocol'. To end ProtoRep, choose
  112.      "Quit" or simply hit the <ESC> key at the menu.
  113.  
  114.      Send File(s)
  115.      ============
  116.      If you choose "Send File(s)" a sub-menu is displayed to the main
  117.      menu's left. This is a list of available protocols as defined by the
  118.      user (see Install Protocols section). After choosing a protocol,
  119.      ProtoRep will ask for files to send. You will be able to key in as
  120.      many files as you like, but only protocols that support "batch"
  121.      transfers, such as Zmodem, will utilize this feature. ProtoRep will
  122.      keep asking for another file until you leave a "File" prompt blank by
  123.      hitting the <ENTER> key. If you leave the first "File" prompt blank,
  124.      the Send will be aborted and you will be returned to main menu.
  125.      ProtoRep now shells out at executes the transfer as set up by the
  126.      "Install Protocols" menu option.
  127.  
  128.      Receive File(s)
  129.      ===============
  130.      This is executed much like "Send File(s)" except for one difference.
  131.      If no %f is specified in the download command line (see Install
  132.      Protocols section), filenames won't be asked. For protocols like
  133.      Zmodem and True Ymodem the file's name is transferred, so the user
  134.      does not have to specify the filename twice. The downside of this is
  135.      that the file will be receive in the same directory that the protocol
  136.      is being executed. For example: You have DSZ (Zmodem) installed in the
  137.      C:\PROTO directory, but would like your downloaded files in the
  138.      C:\DOWN directory. DSZ allows you to key the drive and path to
  139.      download to as the last parameter it's command line. NOTE: DSZ, unlike
  140.      DOS uses the slash rather than the backslash for path names. So to set
  141.      up DSZ to download to the C:\DOWN directory, put the %f at th